Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Controlling Sequence Grabber Components

SGGetMovie

The SGGetMovie function returns a reference to the movie that contains the data collected during a record operation. You can use this movie identifier with Movie Toolbox functions. However, you should not dispose of this movie--it is owned by the sequence grabber component. Furthermore, the sequence grabber component disposes of this movie when you prepare for or start the next record or preview operation, or when you close the connection to the sequence grabber. If you want to work with a movie containing the collected data, use the Movie Toolbox's NewMovieFromFile function (see the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for more information).

You can call this function only after you have stopped the record operation by calling the SGStop function.

pascal Movie SGGetMovie (SeqGrabComponent s);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

DESCRIPTION

The SGGetMovie function returns a reference to the movie that contains the data collected during a record operation. If there is no current movie, either because you are in preview mode or because you have not yet stopped the record operation, the sequence grabber component sets this returned reference to nil.

RESULT CODE

seqGrabInfoNotAvailable

-9407

Sequence grabber cannot support request

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help